home *** CD-ROM | disk | FTP | other *** search
/ Collection of Tools & Utilities / Collection of Tools and Utilities.iso / batchut / cc352.zip / COPYCON.DOC next >
Text File  |  1989-11-03  |  22KB  |  576 lines
  1.      
  2.      
  3.      
  4.      
  5.      
  6.      
  7.      
  8.      
  9.      
  10.      
  11.      
  12.      
  13.      
  14.      
  15.      
  16.      
  17.      
  18.      
  19.      
  20.      
  21.      
  22.      
  23.      
  24.      
  25.                                   CopyCon
  26.      
  27.      
  28.                                  Version 3.50
  29.                                September 1989
  30.      
  31.      
  32.      
  33.      
  34.      
  35.      
  36.      
  37.      
  38.      
  39.      
  40.      
  41.      
  42.      
  43.      
  44.      
  45.      
  46.      
  47.      
  48.      
  49.      
  50.      
  51.                                        by
  52.                               John E. Bean, P.E.
  53.                               JB Technology Inc.
  54.                                28701 N. Main St.
  55.                             Ridgefield, Wa. 98642
  56.                                          
  57.  
  58.      
  59.      
  60.      
  61.      
  62.                                  INTRODUCTION
  63.      
  64.      
  65.      CopyCon is a program to be used in lieu of the DOS command COPY CON.  I
  66.      have  used COPY CON numerous times in creating batch files and  miscel-
  67.      laneous small text files. 
  68.      
  69.      I have experienced many frustrating moments using COPY CON.  I have ac-
  70.      cidently  overwritten existing files.  I have mistyped commands only to
  71.      notice  them while entering the next line.  I have also wanted to  have
  72.      graphic boxes in my batch files.
  73.      
  74.      CopyCon  alleviates all of the above problems.  It checks to see if the
  75.      specified  file exists,  and if it does CopyCon provides either loading
  76.      the existing file or allows the existing file to be overwritten.  Copy-
  77.      Con  also has full screen editing capability and built in Macros  which
  78.      aids in creating files.
  79.      
  80.      CopyCon  was written in Turbo Pascal 5.0 using routines from Turbo  5.0
  81.      Professional.
  82.      
  83.      CopyCon  is  so easy to use that this manual is not necessary  but  the
  84.      following sections will briefly discuss how to use CopyCon.
  85.  
  86.      
  87.      
  88.      
  89.                                  LIMITATIONS
  90.      
  91.      I  have designed CopyCon for typical batch files and small text  files.
  92.      It is not designed to be a text editor!  If you need a text editor, Ez-
  93.      Doss (A Dos Shell), which  I have written, includes a text editor. 
  94.      
  95.      There are two main limitations that I designed into this program.  They
  96.      are:
  97.    
  98.                * The  maximum length of a text line is 80  charac-
  99.                  ters.
  100.                * There is no word wrap.
  101.             
  102.      These limitations were done to distinguish the difference between Copy-
  103.      Con and a text editor.   
  104.  
  105.      
  106.      
  107.      
  108.                                GETTING STARTED
  109.      
  110.      CopyCon is comprised of two (2) files. They are:
  111.           * Copycon.exe - The executable program.
  112.           * Copycon.doc - This documentation. 
  113.      
  114.      Start CopyCon by issuing the following command at the DOS prompt:      
  115.             A:>CopyCon (filename).
  116.      
  117.      As  you can see this is identical to using the DOS command COPY CON ex-
  118.      cept there is not a space between Copy and Con. The user is responsible
  119.      for providing a valid filename.
  120.      
  121.      Once  the program is loaded into memory,  the program will check to see
  122.      if your computer has a color graphics card. If it does the program will
  123.      be  displayed in color.  You can force CopyCon to be displayed in black
  124.      and  white by typing in "/bw"  AFTER the filename on the command  line.
  125.      For  example;  if you wish to create a batch file named  "CPY.BAT"  and
  126.      have CopyCon be in black and white the following is the correct syntax.
  127.      
  128.                               A:>CopyCon  CPY.BAT /bw
  129.      
  130.      Next  the screen will be cleared,  ">CopyCon  (filename)"  will be dis-
  131.      played in the upper left hand corner.  Several other items will be dis-
  132.      played to the right of the file name. They are:
  133.           * F1 - Help:     A  help menu is available simply by  de   
  134.                            pressing the F1 function key.  The help    
  135.                            menu  provides  information on  editing
  136.                            keys and several batch file command.
  137.           * F2 - Macros:   Depressing  the  F2 function  key  will
  138.                            display the predefined Macros.
  139.           * 1,1:           The  y,x position of the cursor.  The y
  140.                            position is the FILE LINE position.
  141.           * INS:           If  the insert mode is ON then INS will    
  142.                            be displayed. 
  143.           * [max line]:    The  number displayed inside the "[  ]"
  144.                            is  the  maximum number of  lines  your
  145.                            file can have. For a 640K machine, this     
  146.                            should be around 5000.
  147.      
  148.      If the file entered on the command line exists,  a pop up menu will ap-
  149.      pear offering the following choices:
  150.           * LOAD:        This  option will load the existing  file    
  151.                          and  CopyCon  can be used to  modify  the    
  152.                          file.
  153.           * OVERWRITE:   This  option will overwrite the  existing    
  154.                          file. 
  155.           * EXIT:        This option will abort CopyCon.
  156.      
  157.      The cursor will be located at the left hand column  of your screen. You
  158.      are now ready to create/edit your file.
  159.      
  160.  
  161.      
  162.      
  163.                               EDITING COMMANDS
  164.      
  165.      CopyCon  provides simple editing commands.  These commands can be  dis-
  166.      played  while  editing through the Help Menu which is accessed  by  de-
  167.      pressing  the F1 function key.  The editing commands can be broken into
  168.      the following sections.
  169.      
  170.      CURSOR PAD KEYS:
  171.        Up Arrow Key:
  172.           Depressing  the Up arrow key will move the cursor to the
  173.           previous line. Depressing the Up arrow key while on line
  174.           one will result in the display of an error message.
  175.      
  176.        Down Arrow Key:
  177.           Depressing  the  Down arrow key will move the cursor  to
  178.           the  next line.  Depressing the Down arrow key while  on
  179.           the  last line entered will result in the display of  an
  180.           error message.
  181.      
  182.        Left Arrow Key:
  183.           Depressing  the Left arrow key will move the cursor  one
  184.           position  left on the current line.  Depressing the Left
  185.           arrow  key  while at the leftmost column on  the  screen
  186.           will result in the display of an error message.
  187.      
  188.        Right Arrow Key:
  189.           Depressing  the Right arrow key will move the cursor one
  190.           position right on the current line. Depressing the Right
  191.           arrow  key  while at the rightmost column on the  screen
  192.           will result in the display of an error message.
  193.      
  194.        Home Key:
  195.           Depressing  the  HOME  key will move the cursor  to  the
  196.           leftmost position on the current line.
  197.      
  198.        End Key:
  199.           Depressing  the  END  key will move the  cursor  to  the
  200.           rightmost position on the current line.
  201.      
  202.        Tab Key:
  203.           Depressing  the TAB key will move the cursor right eight
  204.           (8) spaces.
  205.      
  206.        Shift Tab Key:
  207.           Simultaneously  depressing the Shift key and the Tab key
  208.           will move the cursor left eight (8) spaces.
  209.  
  210.      
  211.        Ctrl Home Key:
  212.           Simultaneously  depressing the Ctrl key and the HOME key
  213.           will move the cursor to the top of the screen.
  214.      
  215.        Ctrl End Key:
  216.           Simultaneously  depressing the Ctrl key and the END  key
  217.           will move the cursor to the bottom of the screen.
  218.      
  219.        Ctrl PgDn Key:
  220.           Simultaneously  depressing the Ctrl key and the PgDn key
  221.           will move the cursor to the end of the file. If the cur-
  222.           sor  is already at the end of the file an error  message
  223.           will be displayed.
  224.      
  225.        Ctrl PgUp Key:
  226.           Simultaneously  depressing the Ctrl key and the PgUp key
  227.           will move the cursor to the top of the file. If the cur-
  228.           sor  is already at the top of the fi